home *** CD-ROM | disk | FTP | other *** search
/ Enter 2005 August / EnterCD 08_2005.iso / dosapps / freedos / help / sys.txt < prev    next >
Encoding:
Text File  |  2002-02-08  |  6.4 KB  |  178 lines
  1. SYS documentation by Jeremy Davis
  2. Updated by Bart Oldeman
  3.  
  4. SYS's standard behavior is very similar (though in
  5. my opinion improved) to that of other DOSes.
  6. SYS (no options) should provide a general usage,
  7. and SYS CONFIG /help (or SYS CONFIG /?) should
  8. provide usage for the new configuration options.
  9.  
  10. Admittedly its brief, but it is there.
  11. Below is a more detailed documentation on its
  12. usage (from memory, but I believe it is close to right).
  13. The best documentation (and maybe only) is the
  14. source itself.
  15.  
  16.  
  17. The simplest usage:
  18.  
  19. SYS dest:
  20.  
  21. dest should be the drive (A:, B:, C:, ...) you wish
  22. to be bootable with FreeDOS (kernel & command.com)
  23. When using this form, KERNEL.SYS and COMMAND.COM
  24. must reside either in the current directory (which
  25. is searched first) or in recent revisions may also
  26. be in the root directory of the current drive.
  27.  
  28. Complete form:
  29.  
  30. SYS [source] dest: [bootsect [BOTH]]
  31.  
  32. Here dest is the same as before, but this time
  33. you specify where KERNEL.SYS and COMMAND.COM are.
  34. Source may simply be a drive (in this case it
  35. is similar to PC & MS SYS).  The current directory
  36. of the specified drive is first searched for
  37. KERNEL.SYS & COMMAND.COM and if not found then
  38. the root directory of the specified drive is tried.
  39. Alternatively, you may specify a path (either fully
  40. qualified or relative) to where KERNEL.SYS and
  41. COMMAND.COM may be found; note that this should 
  42. only search this directory and will fail if they
  43. are not found, ie it will not check for them on
  44. the root directory of the drive specified when
  45. a path is given.  It should also fail if the
  46. source and destination drive are both the same
  47. and would result in trying to SYS from the root
  48. to the root (ie trying to SYS from C:\ to C:\).
  49.  
  50. If you specify a name for "bootsect", for instance,
  51. bootsect.fd, SYS will write to that file instead of
  52. the real boot sector. You will obtain a 512-byte file
  53. containing the boot sector, which can then be used
  54. for dual booting or diagnostic purposes.
  55.  
  56. If you also specify BOTH, sys will write to both
  57. the image file and the boot sector.
  58.  
  59.  
  60. Kernel Configuration Options:
  61.  
  62. Simplest form:
  63.  
  64. SYS CONFIG
  65.  
  66. This will simply display the current settings
  67. for the file KERNEL.SYS in the current directory.
  68. It is useful to see what the options are currently
  69. set to, what options are supported, and should
  70. show valid values along with defaults (defaults are
  71. the valid values with a '*' next to them).
  72.  
  73. Optionally specify file:
  74.  
  75. SYS CONFIG [drive][path]KERNEL.SYS
  76.  
  77. This form behaves as above, except will display
  78. the settings for the kernel file you specify.
  79. drive and path are optional, and generally just
  80. a \ will be used to indicate root directory of
  81. current drive.  KERNEL.SYS specifies the filename
  82. of the kernel, which may not be "KERNEL.SYS",
  83. for example when testing you want to alter
  84. KERNTEST.SYS and later copy (or rename) this to
  85. KERNEL.SYS for booting.
  86.  
  87.  
  88. Changing options:
  89.  
  90. SYS CONFIG OPTION1=value [OPTION2=value ...]
  91.  
  92. This form will read the current settings from
  93. the kernel (KERNEL.SYS in the current directory)
  94. and set the options specified to the value given.
  95. If the value is potentially invalid (too large, too
  96. small, etc) then a warning will be displayed, but
  97. the change will still occur.  The kernel file is
  98. only updated if at least one option is different from the
  99. current settings.  If you wish to force the kernel
  100. file to be written to, then set the same option
  101. twice (OPTION1=oddvalue OPTION1=desiredvalue), with
  102. the 1st time the value being different from the
  103. current one and the rightmost one being the desired
  104. value.  Currently three options are supported.
  105. Note: currently only the 1st three letters are
  106. actually checked, so they may be abreviated to
  107. DLA, SHO, and SKI and with my recent patch you may
  108. specify the value as either a decimal number 0,10,255,...
  109. or as a hexidecimal number 0x0,0xA, 0xFF...
  110.  
  111. DLASORT which may be set to 0 or 1
  112. DLASORT=0 or DLASORT=1
  113. This option is for specifying whether Drive Letter
  114. Assignment should follow the normal MSDOS way of
  115. all primary partitions across drives and then
  116. extended partitions, or the more logical
  117. all partitions (primary & extended) on the 1st 
  118. drive, then repeat for all following drives 
  119. (all primary & extended, then try next drive).
  120. 0 corresponds to MS way and 1 corresponds to first
  121. drive completely, then next ...
  122.  
  123. SHOWDRIVEASSIGNMENT which may be 0 or 1
  124. SHOWDRIVEASSIGNMENT=0 or SHOWDRIVEASSIGNMENT=1
  125. If 1 then the normal drive assignment information
  126. is displayed upon booting.  If 0 then this information
  127. is supressed (not shown).
  128.  
  129. SKIPCONFIGSECONDS which may be -128 to 127.
  130. A negative value ( < 0 ) indicates that F5/F8
  131. processing will be skipped (the kernel won't check
  132. if you pressed these keys, so you can't skip config
  133. file (CONFIG.SYS) processing).  A 0 means you must
  134. have pressed the key precisely for when the kernel
  135. checks for it - essentially skipping, though a well
  136. timed finger will still get to use it.  And any value
  137. greater than 0 is the number of seconds the kernel will
  138. display the prompt and wait for you to press the key
  139. before assuming you didn't.
  140.  
  141. FORCELBA which may be 0 or 1
  142. FORCELBA=0 or FORCELBA=1
  143. If 1 then the kernel will use LBA (extended INT13)
  144. techniques to address all partitions if possible,
  145. even if these have a non-LBA partition type and
  146. are completely below cylinder 1023 (usually the 8GB
  147. boundary). This is 0 by default, for compatibility
  148. reasons. Setting this to 1 may bypass some buggy 
  149. BIOSes and gives slightly better performance.
  150.  
  151. GLOBALENABLELBASUPPORT which maybe 0 or 1
  152. GLOBALENABLELBASUPPORT=0 or GLOBALENABLELBASUPPORT=1
  153. If 0 then LBA will be completely disabled, irrespective
  154. of the FORCELBA setting. You need this if FreeDOS thinks
  155. you have LBA available, but in reality you do not.
  156. This setting is set to 1 by default.
  157.  
  158. Example: To set the kernel in the current directory
  159. to have a timeout of 5 seconds (default is 2) run
  160. SYS CONFIG SKI=5
  161.  
  162.  
  163. Changing options of specified file:
  164.  
  165. SYS CONFIG [drive][path]KERNEL.SYS OPTION1=value ...]
  166.  
  167. This is just like previous section on setting options,
  168. except the first argument after CONFIG specifies which
  169. kernel file to use.  The filename is the same form used
  170. for displaying options of specified kernel file described
  171. above.
  172.  
  173. Example2: To set a kernel in the root directory to
  174. not show drive assignment and change the timeout
  175. to never check
  176. SYS CONFIG \KERNEL.SYS SKI=-1 SHOWDRIVEASSIGNMENT=0x0
  177.  
  178.